package com.example.demo.mapper.system;

import com.example.demo.dto.system.UserQueryDTO;
import com.example.demo.entity.system.SysUser;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户数据访问层
 */
@Mapper
public interface SysUserMapper {
    
    /**
     * 根据用户名查询用户
     *
     * @param username 用户名
     * @return 用户对象
     */
    SysUser selectUserByUsername(String username);
    
    /**
     * 根据ID查询用户
     *
     * @param id 用户ID
     * @return 用户对象
     */
    SysUser selectUserById(Long id);
    
    /**
     * 查询用户列表
     *
     * @param user 用户信息
     * @return 用户集合
     */
    List<SysUser> selectUserList(SysUser user);
    
    /**
     * 分页查询用户列表
     *
     * @param queryDTO 查询参数
     * @return 用户集合
     */
    List<SysUser> selectUserPage(UserQueryDTO queryDTO);
    
    /**
     * 查询用户总数
     *
     * @param queryDTO 查询参数
     * @return 总数
     */
    long selectUserCount(UserQueryDTO queryDTO);
    
    /**
     * 新增用户
     *
     * @param user 用户信息
     * @return 影响行数
     */
    int insertUser(SysUser user);
    
    /**
     * 修改用户
     *
     * @param user 用户信息
     * @return 影响行数
     */
    int updateUser(SysUser user);
    
    /**
     * 修改用户状态
     *
     * @param userId 用户ID
     * @param status 状态
     * @return 影响行数
     */
    int updateUserStatus(@Param("userId") Long userId, @Param("status") Integer status);
    
    /**
     * 逻辑删除用户
     *
     * @param userId 用户ID
     * @return 影响行数
     */
    int deleteUserById(Long userId);
    
    /**
     * 批量逻辑删除用户
     *
     * @param userIds 用户ID数组
     * @return 影响行数
     */
    int deleteUserByIds(Long[] userIds);
    
    /**
     * 校验用户名是否唯一
     *
     * @param username 用户名
     * @return 结果
     */
    int checkUsernameUnique(String username);
    
    /**
     * 校验手机号是否唯一
     *
     * @param phone 手机号
     * @param userId 用户ID
     * @return 结果
     */
    int checkPhoneUnique(@Param("phone") String phone, @Param("userId") Long userId);
    
    /**
     * 校验邮箱是否唯一
     *
     * @param email 邮箱
     * @param userId 用户ID
     * @return 结果
     */
    int checkEmailUnique(@Param("email") String email, @Param("userId") Long userId);
} 